home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / rsc_view.lzh / SCAN_RSC.TXT < prev   
Encoding:
Text File  |  1990-08-01  |  5.7 KB  |  134 lines
  1. SCAN_RSC:     Resource file Viewer and Lister
  2. Author:       Dr. Bob
  3. Date:         09/26/89
  4.  
  5. Requirements: 80 column width is recommended (screen or printer).
  6.  
  7. Operation:    Via the file_selector, a resource file is first read,
  8.               then processed (as though rsrc_load were used).
  9.               Once read, you may either view the 'trees' or opt to
  10.               print a listing of the statistics of the entire file.
  11.               
  12.               Viewing is a simple straight-forward sequential stepping.
  13.               Tree#0 then tree#1 tree#2 etc etc etc...
  14.               After each display, you have the option of listing the
  15.               particulars of that tree (press RETURN) or proceeding
  16.               to the next tree (any other key).  Pressing <ESC> will
  17.               quit the current resource file and allow you to select
  18.               another... or quit to the desktop by clicking on CANCEL
  19.               within the file selector.
  20.               
  21.               When printing or list_while_viewing, the output is in
  22.               the same format. Only standard ASCII is output to the
  23.               printer to allow for a variety of printer models.
  24.               
  25. Object List:
  26.               Each object within a form is listed in the order it exists
  27.               within the resource file. Parent-Child connections are not
  28.               noted. The information shown for each object is:
  29.               
  30.               Obj_Type:   Both descriptive text and type-number are given.
  31.               Obj_Coords: The X,Y coordinates are stated in pixels (this
  32.                           will be different for each resolution)
  33.               Obj_Size:   Width and Height are shown (also depends on rez).
  34.               
  35.               * text:     For TedInfos and Zstrings, the text is shown.
  36.                           Maximum length listed is only 28 characters.
  37.                           Character codes below $20 (32 decimal) are
  38.                           shown as "?" (once again, to allow ANY printer
  39.                           to be used.)
  40.                           TedInfos contain additional info but it is not
  41.                           listed here due to the 80 coulmn constraint.
  42.                           An 'extended-info' function will be available.
  43.  
  44.               * nontext:  For other objects, bitimage,icon or boxchar, the
  45.                           pertinent information is listed.
  46.                           g_boxchar lists the character used.
  47.                           g_bitblk  lists the x,y,w,h from the image_struct.
  48.                           g_icon    lists both the character and the label.
  49.                           
  50.                           g_box, g_ibox and g_progdef info are not listed.
  51.               
  52.               Obj_Flags:  The objects flags are shown. 
  53.               Obj_State:  The objects state is shown.
  54.  
  55. *----------------------------------------------------------------------------*
  56.  
  57.   Extended information refers simply to that information which cannot fit in
  58.   the above listing. This includes TEDINFOS and minor information on boxes.
  59.   
  60.   Data Not Listed:
  61.   
  62.   Tedinfos: ptmplt   font   color    len_string
  63.             pvalid   just   border   len_tmplt
  64.   
  65.   Boxes (g_box,g_ibox):     color    border
  66.   
  67.   Bitblks: color
  68.    
  69.   Icons:   ch_color  chr_x  chr_y    label_x
  70.            label_y   w,h label_box   text_hgt
  71.  
  72.   ProgDefs: Nothing pertinent exists here. This is programmer specific.   
  73.   
  74.                                                       
  75. *----------------------------------------------------------------------------*
  76.  
  77.  
  78.   Any standard resource file can be read and viewed (and listed).
  79.   ---
  80.   
  81.   SCAN_RSC was designed to be used with WERCS (by HiSoft) to fill
  82.   in the gaps. A version that will also list the assigned labels
  83.   to each tree and/or object is currently underway. (once complete,
  84.   the same label_listing will be available for Atari's RSC files)
  85.   
  86.   
  87. *----------------------------------------------------------------------------*
  88.  
  89.   SCAN_RSC is not public domain. It is ShareWare. It may be freely distibuted
  90.   as long as this document file is included with it and neither it nor the
  91.   program file are modified in any way.
  92.   
  93.   I am asking a mere $10.00 'contribution' for this program. All of its design
  94.   is original and all of the coding is mine. 
  95.  
  96.   It was suggested to me to 'disable' the PRINT feature of SCAN_RSC and provide
  97.   that PRINT capability only to 'donators'.
  98.  
  99.   I did not do that.
  100.  
  101.   "Why?", you ask?
  102.  
  103.   Because I trust the ShareWare concept. If you find it useful then donate;
  104.   It's not a lot of money.   If you don't find it useful then erase it.
  105.   
  106.   Support YOUR Shareware authors. (Hey! Even a postcard once in while helps!)
  107.   We like feedback... It lets us know if we're on the right track.
  108.   We're also kinda fond of that green stuff... it helps stave off the hunger.
  109.   (no... I'm not refering to lettuce or cabbage... Brocolli?  Nahhhhhhh...
  110.   c'mon... gimme a break...)
  111.   
  112.   (Dr. Bob wanted me to charge $10.95 but I convinced him to drop it down to
  113.   only $10.00.... Hey! I'm workin' FOR you <but don't tell the Dr. that> :)
  114.   
  115.  
  116.  
  117.  
  118.             
  119.                                                   W.David Parks
  120.                                                     09/27/89
  121.                                                     
  122.  
  123.  send contributions to:                  contact by E-Mail or Message on:
  124.  
  125.   W. David Parks                           CHQ BBS
  126.   180 N. Hazeltine Ave.                    (216) 758-0284
  127.   Campbell, OH  44405-1024                 1200/2400 bps  8/n/1
  128.                                            24hr/7days
  129.                                            ask Dr. Bob
  130.  
  131.  
  132.  
  133. ps: I have a supply of postage stamps 'at-the-ready' ...
  134.